home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d3 / stack_10.arc / STACK.DOC < prev   
Text File  |  1989-02-23  |  6KB  |  151 lines
  1. STACK - Command Line Editor/Enhancer, Version 1.0  - by Shane Bergl
  2. =================================================
  3.  
  4. WHAT IS IT ?
  5. ------------
  6.  
  7. STACK is a program designed to help you at the DOS prompt. It installs
  8. in memory as a TSR program, allowing you to perform the following 
  9. functions:
  10.  
  11. 1. Edit commands you type on the command line.
  12. 2. Recall previous commands with the touch of a cursor key.
  13. 3. Select from a list of past commands from a window.
  14. 4. Enter commonly used commands with a single function key.
  15. 5. Assign your own commands to a function key.
  16. 6. Customize the function key commands and save them permanently.
  17.  
  18. Once you start using STACK, you'll wonder how you ever got along 
  19. without it.
  20.  
  21. INSTALLING STACK
  22. ----------------
  23.  
  24. Install stack by simply copying STACK.COM to your DOS boot disk or to
  25. your hard disk.  On a hard disk, copy the program to the root
  26. directory, or to a directory included in the PATH statement in your
  27. AUTOEXEC.BAT file.
  28.  
  29. To use the program, simply enter the command: STACK <Enter> at the DOS
  30. prompt.  You can add this command to your AUTOEXEC.BAT file to 
  31. automatically load STACK when you boot up.
  32.  
  33. COMPATIBILITY WITH OTHER UTILITIES
  34. ----------------------------------
  35.  
  36. STACK uses some DOS interrupts and can clash with other
  37. memory-resident utilities, especially keyboard enhancers such as
  38. SMARTKEY. If you load it before such utilities, there shouldn't be any
  39. problem.
  40.  
  41.  
  42. COPYRIGHT, ETC
  43. --------------
  44.  
  45. While I claim ownership of the code, there are no restrictions on who
  46. can use STACK or under what conditions. Go for it.
  47.  
  48.  
  49. COMMANDS
  50. --------
  51.  
  52. Note: STACK is only active at the DOS prompt.
  53.  
  54. Windows  - Some notes about how windows are controlled.
  55.          . When the window is opened and the command stack is
  56.            showing, the current command is highlighted.
  57.          . STACK only opens a window if PGUP or PGDN is pressed.
  58.            This saves having windows flashing around the screen
  59.            when you know where the command you want is.
  60.          . If a window is displayed (using PGUP or PGDN) and the
  61.            other key is pressed (PGDN or PGUP respectively) then
  62.            the window content is swapped.
  63.          . Although up to 80 characters of commands are stored, to
  64.            save space on the screen, only the first 32 characters
  65.            of commands are displayed in the window.
  66.  
  67. Cursor Pad Keys
  68.  
  69. Up       - Select the preceding command and display it at the
  70.            DOS prompt. If the window is open, select the correct
  71.            command list to display and highlight the command.
  72.            Press <Enter> to carry out the highlighted command.
  73.  
  74. Down     - Select the next command and display it at the DOS
  75.            prompt. If the window is open, select the correct
  76.            command list to display and highlight the command.
  77.  
  78. PGUP     - Open a window and display the command stack.
  79.  
  80. PGDN     - Open a window and display the commands for the
  81.            function keys. Several useful commands are
  82.            pre-programmed, but can be changed to suit
  83.            your needs. To execute the command, press the
  84.            appropriate function key.
  85.  
  86. HOME     - Move the cursor to the left of the command line.
  87.  
  88. END      - Move the cursor to the right of the command line.
  89.  
  90. DEL      - Delete the character at the cursor.
  91.  
  92. INS      - Toggle insert mode. Insert on is indicated by a block-
  93.            shaped cursor
  94.  
  95. Backspace- Delete the character to the left of the cursor
  96.  
  97. ESC      - Clear the command line and close the window.
  98.  
  99. TAB      - Delete the currently highlighted command from the stack.
  100.  
  101. Fn       - Issue the command associated with that function key.
  102.  
  103. Shift-Fn   You can't issue the command associated with a function
  104.            key using the highlight bar - you must press the
  105.            function key. The function keys that can be programmed
  106.            in this way are F1 to F10 and Shift-F1 to Shift-F5.
  107.  
  108. Ctrl-Fn  - Copy the current command to this function key. Ctrl-F1
  109.            to Ctrl-F10 copy to the corresponding function key,
  110.            Alt-F1 to Alt-F5 copy to Shift-F1 to Shift-F5
  111.            respectively. If STACK is currently in insert mode (i.e.,
  112.            you pressed INS and the block cursor is showing), then NO
  113.            carriage return is added to the end. This means that when
  114.            you use that function key you can add some more to the end
  115.            before pressing Return/Enter. If insert mode is off, then
  116.            a carriage return is added to the end and the command will
  117.            be executed as soon as you press the function key.
  118.  
  119. Ctrl-END - Modify STACK.COM by writing the current (i.e. in-memory)
  120.            definitions of the function keys to STACK.COM. The memory
  121.            copy of STACK expects STACK.COM to be located in the
  122.            current drive and directory. If it isn't, you'll get a
  123.            cryptic error message on the command line (it isn't placed
  124.            in the DOS buffer so just type over the error message).
  125.  
  126.  
  127. MODIFICATIONS
  128. -------------
  129.  
  130. For those who are programmers, the following information is provided
  131. to help you modify the colours using DEBUG, PC Tools, etc. (Addresses
  132. are offset from start of file - add 100h if using DEBUG).
  133.  
  134. Address
  135. 06Ch     - This byte controls the main window colours. The
  136.            first 4 bits are the background colour, the next 4
  137.            are the text colour
  138.  
  139. 06Dh     - As above, but controls the colours for the highlight
  140.            bar
  141.  
  142.  
  143.  
  144. CONTACTING THE AUTHOR
  145. ---------------------
  146.  
  147. If you discover bugs in STACK or would like to discuss some aspects of
  148. it, I can be contacted at home on (062) 369 216 or by writing to PO
  149. Box 78, Dickson, Australian Capital Territory, 2602
  150.  
  151.